-- *****************************************************************
-- CISCO-HEALTH-MONITOR-MIB.my: Health Monitor MIB
--
-- December 2001, Peter Hanselmann & Gene Clendon
--
-- Copyright (c) 2001, 2002 by cisco Systems, Inc.
-- All rights reserved.
-- *****************************************************************
--CISCO-HEALTH-MONITOR-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,OBJECT-TYPE,NOTIFICATION-TYPE,Gauge32,Counter32FROM SNMPv2-SMI
SnmpAdminStringFROM SNMP-FRAMEWORK-MIB
TruthValue,TEXTUAL-CONVENTIONFROM SNMPv2-TC
MODULE-COMPLIANCE,OBJECT-GROUP,NOTIFICATION-GROUPFROM SNMPv2-CONF
entPhysicalIndex
FROM ENTITY-MIB
ciscoMgmt
FROM CISCO-SMI;ciscoHealthMonitorMIB MODULE-IDENTITYLAST-UPDATED"200211140900Z"-- November 14, 2002 9:00 AMORGANIZATION"Cisco Systems, Inc."CONTACT-INFO" Cisco Systems
Customer Service
Postal: 170 W. Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-healthmonitor@cisco.com"DESCRIPTION"Health Monitor MIB module.
The Health Monitor uses a model based on events of varying
severity and frequency, and predefined rules, to generate
a metric that represents a system's (and its subsystems')
level of health.
The events are typically internally generated notifications
in response to detrimental or correctional changes in the
state of the hardware or software of the system. Detrimental
events are classified under one of the following severity
levels:
Catastrophic - Causes or leads to system failure
Critical - Major subsystem or functionality failure
High - Potential for major impact to important
functions
Medium - Potential for minor impact to functionality
Low - Negligible impact to functionality
Whilst correctional events fall under the following
classification:
Positive - Not a fault event. May cause or lead to
the return of functionality
This MIB module provides information for tracking occurrences
of the above events, and presents the associated health
metric for the system and its component subsystems."REVISION"200211140900Z"-- November 14, 2002 9:00 AMDESCRIPTION"Initial version of this MIB module."::={ ciscoMgmt 243}-- Health Monitor MIB objects definitions-- The Health Monitor MIB consists of:
-- Health Monitor Notifications
-- Health Monitor TableciscoHealthMonitorMIBObjects OBJECTIDENTIFIER::={ ciscoHealthMonitorMIB 1}--
-- Health Textual Conventions
--HealthLevel ::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"Reflects the health of a system or subsystem based on
system events and predefined rules, expressed as a
percentage. The UNITS clause associated with each object
will indicate the degree of precision."SYNTAXGauge32(0..10000)--
-- Health Monitor Group
--ciscoHealthMonitorTable OBJECT-TYPESYNTAXSEQUENCEOF CiscoHealthMonitorEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table contains Health Monitor statistics for physical
entities and their constituent hardware and/or software
subsystems.
The Health Monitor statistics present in each row provide
information such as the computed health of the indicated
subsystem and the number of faults it has experienced."::={ ciscoHealthMonitorMIBObjects 1}ciscoHealthMonitorEntry OBJECT-TYPESYNTAX CiscoHealthMonitorEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A Health Monitor statistics entry.
The entPhysicalIndex identifies the physical entity (chassis
or container), while the ciscoHealthMonitorSubsysName
identifies by name the appropriate subsystem for which these
statistics apply.
If there are other entities such as peer routers or line
cards then, in the context of this MIB, these are also
defined to be in the same system. If these entities also
run an instance of the Health Monitor then the summary
information from the distributed Health Monitors is
obtained here."INDEX{ entPhysicalIndex,IMPLIED ciscoHealthMonitorSubsysName }::={ ciscoHealthMonitorTable 1}
CiscoHealthMonitorEntry ::=SEQUENCE{-- implied index
ciscoHealthMonitorSubsysName SnmpAdminString,-- health and notification level
ciscoHealthMonitorHealth HealthLevel,
ciscoHealthMonitorHealthNotifyEnable TruthValue,
ciscoHealthMonitorHealthNotifyHighThreshold HealthLevel,
ciscoHealthMonitorHealthNotifyLowThreshold HealthLevel,-- event statistics
ciscoHealthMonitorCatastrophicFaults Counter32,
ciscoHealthMonitorCriticalFaults Counter32,
ciscoHealthMonitorHighSeverityFaults Counter32,
ciscoHealthMonitorMediumSeverityFaults Counter32,
ciscoHealthMonitorLowSeverityFaults Counter32,
ciscoHealthMonitorPositiveEvents Counter32}ciscoHealthMonitorSubsysName OBJECT-TYPESYNTAXSnmpAdminString(SIZE(1..128))MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A textual string containing the name of the hardware or
software subsystem. A management station wishing to obtain
summary statistics for a physical entity should use a value
of 'summary' for this object."::={ ciscoHealthMonitorEntry 1}ciscoHealthMonitorHealth OBJECT-TYPESYNTAX HealthLevel
UNITS"0.01 percent"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The computed current health of this subsystem on the
specified entity.
This health metric is based on predefined rules that
specify how the health should be adjusted in response to
certain events of varying severity and frequency. As these
events are encountered by each subsystem or physical entity,
the appropriate rules are applied and the health is modified
accordingly."::={ ciscoHealthMonitorEntry 2}ciscoHealthMonitorHealthNotifyEnable OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION
"Enables or disables health level notifications. When set
to true(1), the ciscoHealthMonitorHealthLevel notification
is enabled. When set to false(0), the
ciscoHealthMonitorHealthLevel notification is disabled.
If such a notification is desired, it is the responsibility of
the management entity to ensure that the SNMP administrative
model is configured in such a way as to allow the notification
to be delivered."DEFVAL{ false }::={ ciscoHealthMonitorEntry 3}ciscoHealthMonitorHealthNotifyHighThreshold OBJECT-TYPESYNTAX HealthLevel
UNITS"0.01 percent"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Specifies the health level at which a
ciscoHealthMonitorHealthLevel notification will be
generated for the specified subsystem and entity.
A notification will only be generated if the health
level had previously reached the low threshold level
prior to reaching this high threshold level.
Health levels oscillating within the high and the low
threshold levels do not generate notifications.
A health level going from low threshold (or below)
to high threshold (or above) represents a return
to normal health for the specified subsystem.
Set your optimal health level to this threshold."DEFVAL{10000}::={ ciscoHealthMonitorEntry 4}ciscoHealthMonitorHealthNotifyLowThreshold OBJECT-TYPESYNTAX HealthLevel
UNITS"0.01 percent"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Specifies the health level at which a
ciscoHealthMonitorHealthLevel notification will be
generated for the specified subsystem and entity.
A notification will only be generated if the health
level had previously reached the high threshold level
prior to reaching this low threshold level.
Health levels oscillating within the high and the low
threshold levels do not generate notifications.
A health level going from high threshold (or above)
to low threshold (or below) represents a deterioration
of the health for the specified subsystem.
Set your unacceptable health level to this threshold."DEFVAL{0}::={ ciscoHealthMonitorEntry 5}ciscoHealthMonitorCatastrophicFaults OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of catastrophic faults that have occurred in
this subsystem on the specified entity since the system
was initialized."::={ ciscoHealthMonitorEntry 6}ciscoHealthMonitorCriticalFaults OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of critical faults that have occurred in this
subsystem on the specified entity since the system was
initialized."::={ ciscoHealthMonitorEntry 7}
ciscoHealthMonitorHighSeverityFaults OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of high severity faults that have occurred in
this subsystem on the specified entity since the system
was initialized."::={ ciscoHealthMonitorEntry 8}ciscoHealthMonitorMediumSeverityFaults OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of medium severity faults that have occurred in
this subsystem on the specified entity since the system
was initialized."::={ ciscoHealthMonitorEntry 9}ciscoHealthMonitorLowSeverityFaults OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-only
STATUScurrentDESCRIPTION"The number of low severity faults that have occurred in
this subsystem on the specified entity since the system
was initialized."::={ ciscoHealthMonitorEntry 10}ciscoHealthMonitorPositiveEvents OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of positive events that have occurred in this
subsystem on the specified entity since the system was
initialized."::={ ciscoHealthMonitorEntry 11}--
-- Notifications
--ciscoHealthMonitorMIBNotifs OBJECTIDENTIFIER::={ ciscoHealthMonitorMIB 0}ciscoHealthMonitorHealthLevel NOTIFICATION-TYPEOBJECTS{
ciscoHealthMonitorHealth
}
STATUScurrentDESCRIPTION"A ciscoHealthMonitorHealthLevel notification is sent when
the health of a subsystem reaches either the
ciscoHealthMonitorHealthNotifyLowThreshold or
ciscoHealthMonitorHealthNotifyHighThreshold threshold
as described above."::={ ciscoHealthMonitorMIBNotifs 1}--
-- Conformance information
--ciscoHealthMonitorMIBConform OBJECTIDENTIFIER::={ ciscoHealthMonitorMIB 2}ciscoHealthMonitorMIBCompliances OBJECTIDENTIFIER::={ ciscoHealthMonitorMIBConform 1}ciscoHealthMonitorMIBGroups OBJECTIDENTIFIER::={ ciscoHealthMonitorMIBConform 2}--
-- compliance statements
--ciscoHealthMonitorMIBCompliance MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for entities which implement the
Cisco Health Monitor MIB"MODULE-- this moduleMANDATORY-GROUPS{
ciscoHealthMonitorGroup
}::={ ciscoHealthMonitorMIBCompliances 1}--
-- Units of conformance
--ciscoHealthMonitorGroup OBJECT-GROUPOBJECTS{
ciscoHealthMonitorHealth,
ciscoHealthMonitorHealthNotifyEnable,
ciscoHealthMonitorHealthNotifyHighThreshold,
ciscoHealthMonitorHealthNotifyLowThreshold,
ciscoHealthMonitorCatastrophicFaults,
ciscoHealthMonitorCriticalFaults,
ciscoHealthMonitorHighSeverityFaults,
ciscoHealthMonitorMediumSeverityFaults,
ciscoHealthMonitorLowSeverityFaults,
ciscoHealthMonitorPositiveEvents
}STATUScurrentDESCRIPTION"The collection of objects providing health information."::={ ciscoHealthMonitorMIBGroups 1}
ciscoHealthMonitorMIBNotificationGroup NOTIFICATION-GROUPNOTIFICATIONS{
ciscoHealthMonitorHealthLevel
}STATUScurrentDESCRIPTION"Set of notifications implemented in this module."::={ ciscoHealthMonitorMIBGroups 2}END